home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d13 / osmo107.arc / OSMOSIS.DOC < prev    next >
Text File  |  1991-07-08  |  19KB  |  529 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                     Osmosis
  10.  
  11.                                   Version 1.07
  12.  
  13.                                Copyright 1991 By
  14.                                    Randy Rasa
  15.                                   18215 Troost
  16.                                 Olathe, KS 66062
  17.  
  18.  
  19.  
  20.      What Is It?     ___________
  21.  
  22.         Osmosis, also known as "Treasure Trove", is a solitaire card game
  23.         that requires skillful play and a good portion of luck, but rewards
  24.         as an enjoyable and addictive diversion.  When played with actual
  25.         cards, it requires a lot of dealing and shuffling, but this
  26.         computer version makes the game simple and fast.
  27.  
  28.  
  29.      Program Requirements     ____________________
  30.  
  31.         Osmosis requires 256K of memory, EGA or higher graphics capability,
  32.         and a Microsoft-compatible mouse.  If you are not sure you have the
  33.         right hardware, just run the program.  If there's a problem, the
  34.         program will let you know.
  35.  
  36.         In addition to the program file (OSMOSIS.EXE), the game requires
  37.         that the card definition files (CARDS.CD1 and CARDS.CD2) be in the
  38.         current directory.  These files contain the bit-maps for each
  39.         cardface in the deck.
  40.  
  41.  
  42.      Using The Mouse     _______________
  43.  
  44.         The mouse pointer will appear as a white arrow with black edges.
  45.         In general, the left button is used to select the object being
  46.         pointed to (a card or an on-screen button).
  47.  
  48.         If you have a three-button mouse, the middle button will blank the
  49.         screen.  This can also be accomplished by pressing the left and
  50.         right buttons simultaneously.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      Osmosis Documentation                                           Page 2
  72.  
  73.  
  74.      How To Play     ___________
  75.  
  76.         Osmosis uses a standard 52-card deck (no jokers).  To begin the
  77.         game the deck is shuffled, then four piles of four cards each are
  78.         dealt at the left.  The piles form the reserve, and the top card of
  79.         each is available for play.
  80.  
  81.         One card is dealt to the right of the first reserve, forming the
  82.         first foundation.  As the other cards of the same rank become
  83.         available, they may be played in a column below the first
  84.         foundation, forming the other three foundations.
  85.  
  86.         Cards are dealt from the deck three at a time, with only the top
  87.         card available for play to the foundations.
  88.  
  89.         Foundations are built in suit, regardless of order.  On the first
  90.         foundation, any card of the same suit may built as soon as it
  91.         becomes available.  On each lower foundation, a card may be built
  92.         only if a card of the same rank has been built on the foundation
  93.         above it.
  94.  
  95.         For example, if the first foundation card is a three of hearts,
  96.         then any heart can be played on the first foundation as soon as it
  97.         becomes available, say, for illustration, the seven and nine.  Now
  98.         suppose the second foundation is  the three of clubs.  If the seven
  99.         or nine of clubs become available, they can be played on the second
  100.         foundation, but no other club can be played until the corresponding
  101.         heart has been built.
  102.  
  103.         When all cards have been dealt from the deck, you may redeal as
  104.         often as you like, until either the game is won (by moving all
  105.         cards to the foundations) or lost (no more moves can be made.
  106.  
  107.         When the "peek" option is enabled, the reserves will be spread out
  108.         so that all of their cards can be seen.  This allows you to spot
  109.         any potential blocks before beginning the game.  The situation to
  110.         look out for is two cards of the same rank in the same reserve
  111.         pile, especially is the lower card is of the first foundation suit.
  112.         If this is the case then the game is hopeless, at least as far as
  113.         winning, though you can still play it and perhaps even reach a
  114.         respectable score.
  115.  
  116.         Note: to deal cards from the deck, simply click on the card back.
  117.         When the deck is exhausted, click it again to gather the cards back
  118.         up in preparation for a redeal.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.      Osmosis Documentation                                           Page 3
  138.  
  139.  
  140.      Buttons     _______
  141.  
  142.         Along the right side of the screen are a number of "buttons", which
  143.         may be selected by pointing and clicking with the mouse.  The
  144.         buttons are:
  145.  
  146.            Options: This button brings up the options menu, which you can
  147.               use to set your preferences for the following:
  148.  
  149.               Sound: Select "Off" to disable the beeps, clicks, and various
  150.                  other noises the program makes.  Select "On" to enable the
  151.                  sounds.
  152.  
  153.               Peek: When this is set "On" the reserve piles will be spread
  154.                  out so that all cards can be seen, thus helping you spot
  155.                  and perhaps avoid blocks.
  156.  
  157.               Session Statistics: When this option is set to "On", the
  158.                  program will keep track of your statistics (games played,
  159.                  games won, change in average score) throughout the game
  160.                  and then display them when you quit.  (Note: During play,
  161.                  you can also display the session statistics by clicking on
  162.                  the score box.)
  163.  
  164.               Background Color: Click on the up-arrow and down-arrow to
  165.                  step through the available background colors, until you
  166.                  find one that suits your tastes.
  167.  
  168.               Card Back: Click on the up-arrow and down-arrow to cycle
  169.                  through the available card designs until you find one you
  170.                  like.
  171.  
  172.               Once you've set things to your liking, you may click on the
  173.               "OK" button to save your preferences to disk, or on the
  174.               "Cancel" button to exit the Options menu without changing
  175.               anything.
  176.  
  177.            Help: This button will bring up several pages of help screens,
  178.               which you can view by clicking on the "Next" or "Prev"
  179.               buttons to move from page to page.  When you are finished
  180.               reading the help, click on the "Done" button to exit.
  181.  
  182.            New Game: This button will end the current game, update your
  183.               statistics, and start a new game.  Note that the stats will
  184.               only be updated if you have a score greater than one.  This
  185.               allows you to evaluate the layout of the cards and, if you
  186.               don't like what you see, to begin a new game without having
  187.               it count against you.
  188.  
  189.            Quit: Click on this button to exit the program.  If you have a
  190.               score greater than one, your statistics will be updated and
  191.               displayed briefly before returning you to DOS.  Another way
  192.               to exit the game is to press the "Abort" key (F10).  If you
  193.               press F10 (and select the "Exit This Program" option in the
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.      Osmosis Documentation                                           Page 4
  204.  
  205.  
  206.               pop-up dialog box), the program will quit to DOS without
  207.               saving the data file (and thus not giving you a low score if
  208.               you have to quit the program in the middle of a game).
  209.  
  210.  
  211.      Statistics     __________
  212.  
  213.         Osmosis keeps track of the score (the number of cards you've played
  214.         to the foundations), the total number of games you've played, the
  215.         number of games you've won (expressed as both a number and a
  216.         percentage), and your average score.  At the end of each game, the
  217.         statistics are written to disk, either in the default OSMOSIS.DAT
  218.         or in the data file specified on the command line.  The data file
  219.         also contains the preferences you set in the options menu.
  220.  
  221.         To specify a data file on the command line, start up Osmosis with
  222.         the following syntax:
  223.  
  224.                                OSMOSIS filename.ext
  225.  
  226.         This allows several different people to use the same copy of
  227.         Osmosis on the same machine, yet keep separate statistics for each
  228.         person.  For example, suppose three people (Tom, Dick, and Harry)
  229.         played the game at various times on the same machine.  They could
  230.         each easily keep personalized data files, containing their scores
  231.         and preferences.  Tom would use his data file by typing:
  232.  
  233.                                   OSMOSIS TOM.DAT
  234.  
  235.         Likewise, Dick and Harry could have data files called DICK.DAT and
  236.         HARRY.DAT.  Note that the "DAT" extension could be "SCR" or "HGH",
  237.         or whatever, as long as it is three letters or less.
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.      Osmosis Documentation                                           Page 5
  270.  
  271.  
  272.      Legalese     ________
  273.  
  274.         Osmosis is shareware.  As such, you can play it, copy it, and give
  275.         it away as you wish.  In fact, you are encouraged to distribute the
  276.         program to friends, family, and strangers alike.  This includes
  277.         distribution via electronic bulletin board systems (BBS), user's
  278.         groups, and disk-distribution services.  All that I ask is that the
  279.         program remain unaltered, and be distributed in an archive
  280.         consisting of:
  281.  
  282.            OSMOSIS.EXE ............. the program
  283.            OSMOSIS.DOC ............. documentation
  284.            CARDS.CD1 ............... card definition file #1
  285.            CARDS.CD2 ............... card definition file #2
  286.  
  287.  
  288.      Registration     ____________
  289.  
  290.         Osmosis is shareware.  If you enjoy the game, please support it.
  291.         There are three registration packages available:
  292.  
  293.            1. Basic Registration ................................... $5.00
  294.  
  295.               This minimum registration will get you the latest registered
  296.               (no shareware "beg" message) version of Osmosis on a diskette
  297.               of your choice, along with a registration code good for all
  298.               future updates.
  299.  
  300.            2. Package Deal #1 ..................................... $10.00
  301.  
  302.               This package consists of the latest registered version of
  303.               Osmosis, plus shareware versions of my other programs, along
  304.               with a menu program to tie them all together.  Note that all
  305.               of the additional programs are unregistered versions (with
  306.               shareware "beg" screens).  You will also receive a
  307.               registration code good for all future updates of Osmosis.
  308.  
  309.            3. Package Deal #2 ..................................... $15.00
  310.  
  311.               This package consists of the latest registered versions of
  312.               Osmosis, plus registered versions of my other programs, along
  313.               with a menu program to tie them all together.  Note that all
  314.               of the additional programs are fully registered versions (no
  315.               shareware "beg" screens).  You will also receive registration
  316.               codes good for all future updates of Osmosis and the programs
  317.               included with your registration.
  318.  
  319.         Basic registration is available on a 5.25", 360K disk or on a
  320.         3.50", 720K disk.  The package deals are available on two 360K
  321.         disks (with the programs ZIPped (with the PKZIP compression
  322.         program) to pack as much as possible onto each disk), one 720K disk
  323.         (ZIPped), or one 5.25", 1.2M disk.  If you do not have access to
  324.         PKZIP, you'll need to order the package deals on a 1.2M disk.
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.      Osmosis Documentation                                           Page 6
  336.  
  337.  
  338.         The programs that you will get with the package deals are:
  339.  
  340.            Midnight Oil: An EGA solitaire card game, otherwise known as La
  341.               Belle Lucie and Three Shuffles and a Draw.  In this game the
  342.               deck is dealt into seventeen fans of three cards each.  Cards
  343.               are moved from the fans to four foundations, which are then
  344.               built up in suit from Ace to King.  Midnight Oil is one of
  345.               the best solitaires, affording great opportunity for skillful
  346.               play.  The game keeps statistics in a disk file, and has a
  347.               special auto mode that makes the game especially easy to
  348.               play.
  349.  
  350.            Monte Carlo: An EGA-based solitaire card game in which you try
  351.               to remove pairs of cards from a 5 x 5 matrix.  This easy-to-
  352.               play game offers hours of relaxing fun.  It keeps statistics
  353.               in much the same way as Osmosis, has selectable card designs,
  354.               and a "hint" button that makes the game especially easy to
  355.               learn.
  356.  
  357.            Calculation: This EGA-based solitaire card game is a real brain-
  358.               teaser in which you build up four foundations, each in a
  359.               different sequence.  It requires skill and logical thinking
  360.               to win, but on-screen assistance makes learning and playing
  361.               the game a snap.  It keeps a statistic file like Osmosis and
  362.               has selectable card designs.
  363.  
  364.            Idiot's Delight: An EGA version of "Aces Up", a simple but
  365.               addictive game of luck and skill.  This is one of those games
  366.               that leave you saying "just one more game" time after time
  367.               after time.  As in my other EGA games, it keeps a statistic
  368.               file and offers selectable card backs.
  369.  
  370.            Royal Cotillion: This is a two-deck EGA solitaire in which you
  371.               must build up eight foundations in suit by twos.  It offers
  372.               good opportunity for skillful play, a pleasing layout, and
  373.               hours of engrossing fun.  It keeps a statistics file, has
  374.               selectable card backs, and a time-saving auto mode.
  375.  
  376.            Concentration: An EGA graphics version of the classic memory-
  377.               stretching solitaire.  It keeps a statistics file, features
  378.               selectable card backs, and offers a unique multi-player mode.
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.      Osmosis Documentation                                           Page 7
  402.  
  403.  
  404.         You can print the registration form from the initial shareware
  405.         screen.  Simply select the "Print Registration Form" button, then
  406.         select a destination, either to a printer or a file.  If you elect
  407.         to send the form to a printer, make sure it is on-line and ready.
  408.         The form should print on any standard 80-column printer.  If you
  409.         want to save the form to a file, the file "OSMOSIS.FRM" will be
  410.         created in the current directory.  You can then print out the
  411.         registration form by entering the following command from the DOS
  412.         prompt (with your printer connected and ready):
  413.  
  414.                                COPY OSMOSIS.FRM PRN
  415.  
  416.         Then just fill out the form and send it, along with cash, check or
  417.         money order, to:
  418.  
  419.                                     Randy Rasa
  420.                                    18215 Troost
  421.                                  Olathe, KS 66062
  422.  
  423.  
  424.      Revision History     ________________
  425.  
  426.         1.00  01-03-91  First Public Release.
  427.         1.01  01-11-90  Added "Session Statistics" option.
  428.                         Cosmetic changes.
  429.         1.02  02-15-91  More Cosmetic changes.
  430.         1.03  03-12-91  Added registration procedure.
  431.         1.04  03-23-91  Modified registration procedure.
  432.         1.05  04-23-91  Added option to print registration form.
  433.                         Changed card definition filenames to CARDS.CD*.
  434.         1.06  05-17-91  Fixed problem with equipment test.
  435.         1.07  06-27-91  Added Abort (F10) feature.
  436.                         The program now exits to DOS after running the
  437.                         registration procedure, and the program date and
  438.                         time are set correctly.
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.      Osmosis Documentation                                           Page 8
  468.  
  469.  
  470.      A Note To Registered Users     __________________________
  471.  
  472.         The registration procedure allows previously-registered users to
  473.         update to the new registered version of the program by entering a
  474.         special 'registration code' that was included as part of your
  475.         order.  Run the shareware version of the program with the "/R"
  476.         command-line switch, followed by the registration code, like this:
  477.  
  478.            OSMOSIS /Rxxxxxx
  479.  
  480.         You would, of course use the proper registration code in place of
  481.         the "xxxxxx".  Note also that there should be no space between the
  482.         "R" and the registration code.  After running the program with /R
  483.         switch and the proper code, you'll have a brand-spanking new
  484.         registered version of the program.  What this essentially amounts
  485.         to is unlimited, free updates with each registration.
  486.  
  487.  
  488.         The registration procedure comes with the following limitations:
  489.  
  490.            1. The name your EXE file must be OSMOSIS.EXE.
  491.  
  492.            2. You cannot perform the registration procedure on a compressed
  493.               version (ie: an EXE file processed with PKLite, Diet, or
  494.               LZEXE).  The EXE file may be compressed after the
  495.               registration procedure, but not before.
  496.  
  497.            3. Please do not distribute registered versions of the program.
  498.  
  499.            4. Since the registration procedure is a new feature, there are
  500.               a number of people who have registered earlier versions that
  501.               won't be able to take advantage of it just yet.  But if you
  502.               send me a self-addressed stamped envelope, I'll be happy to
  503.               send you the registration code.
  504.  
  505.  
  506.         Note: You can also change the program back to the shareware version
  507.               by using the "/SW" command-line switch.  This function is
  508.               subject to the same limitations as with the registration
  509.               procedure (ie: the program must be properly named and
  510.               uncompressed).  Please use this option to "un-register" the
  511.               program if you wish to pass it along to anyone.  Also, please
  512.               include all of the files listed under the "Legalese" section
  513.               of this document.  Thanks.
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.